home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat2 / getsockname.0 < prev    next >
Text File  |  1996-09-01  |  2KB  |  44 lines
  1.  
  2. GETSOCKNAME(2)             UNIX Programmer's Manual             GETSOCKNAME(2)
  3.  
  4. NNAAMMEE
  5.      ggeettssoocckknnaammee - get socket name
  6.  
  7. SSYYNNOOPPSSIISS
  8.      _i_n_t
  9.      ggeettssoocckknnaammee(_i_n_t _s, _s_t_r_u_c_t _s_o_c_k_a_d_d_r _*_n_a_m_e, _i_n_t _*_n_a_m_e_l_e_n)
  10.  
  11. DDEESSCCRRIIPPTTIIOONN
  12.      GGeettssoocckknnaammee() returns the current _n_a_m_e for the specified socket.  The
  13.      _n_a_m_e_l_e_n parameter should be initialized to indicate the amount of space
  14.      pointed to by _n_a_m_e. On return it contains the actual size of the name re-
  15.      turned (in bytes).
  16.  
  17. DDIIAAGGNNOOSSTTIICCSS
  18.      A 0 is returned if the call succeeds, -1 if it fails.
  19.  
  20. EERRRROORRSS
  21.      The call succeeds unless:
  22.  
  23.      [EBADF]       The argument _s is not a valid descriptor.
  24.  
  25.      [ENOTSOCK]    The argument _s is a file, not a socket.
  26.  
  27.      [ENOBUFS]     Insufficient resources were available in the system to per-
  28.                    form the operation.
  29.  
  30.      [EFAULT]      The _n_a_m_e parameter points to memory not in a valid part of
  31.                    the process address space.
  32.  
  33. SSEEEE AALLSSOO
  34.      bind(2),  socket(2)
  35.  
  36. BBUUGGSS
  37.      Names bound to sockets in the UNIX domain are inaccessible; getsockname
  38.      returns a zero length name.
  39.  
  40. HHIISSTTOORRYY
  41.      The ggeettssoocckknnaammee() function call appeared in 4.2BSD.
  42.  
  43. 4.2 Berkeley Distribution        June 4, 1993                                1
  44.